home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / megmatic.arc / MEGMATIC.DOC < prev    next >
Text File  |  1987-12-11  |  23KB  |  487 lines
  1.  
  2.           
  3.           
  4.                                MEGA-Matic  (v1.11)
  5.                                     (c) 1987
  6.  
  7.                                  T.I.F. Software
  8.                                   a division of
  9.                               T&L Enterprises, Inc.
  10.                               3826 W. Missouri Ave.
  11.                              Phoenix, Arizona  85019
  12.  
  13.                           Author: Lloyd E. Pulley, Sr.
  14.  
  15.  
  16.  
  17.  
  18.                Disclaimer of Warranty and/or Liability
  19.                (aka..if anything goes wrong, it ain't my fault)
  20.  
  21.              Try  It First Software (hereafter known as  TIF  Software) 
  22.           makes  no warranty,  either expressed or implied,  as to  the 
  23.           usability of the enclosed programs, the documentation and any 
  24.           other related items.
  25.  
  26.              TIF  Software  will  not  be held  liable  for  direct  or 
  27.           incidental  damages resulting from any defect or omission  in 
  28.           these  programs or the documentation.   These  programs  have 
  29.           been  tested  thoroughly  but TIF Software can  not  be  held 
  30.           liable if it doesn't work on your system.
  31.  
  32.              MegaMatic has been tested to run on the 520 ST,  1040  ST, 
  33.           Mega ST2 and the Mega ST4.   It works on an all floppy system 
  34.           and on a system with hard drives.  It works on the older roms 
  35.           and  the  new ones.   It works with or  without  the  blitter 
  36.           installed.  I've even tested it on a 1040 ST that was running 
  37.           2 1/2 megs and the new roms.  But that doesn't mean it'll run 
  38.           on  your system.   Long ago I reached a conclusion that  "all 
  39.           ST's are not created equal".
  40.  
  41.              The  documentation  and programs included  in  this  arced 
  42.           file,  are copyrighted by TIF Software.   These programs  are 
  43.           NOT public domain, they are shareware.
  44.  
  45.              Since  MegaMatic is shareware,  please feel free  to  make 
  46.           copies of these programs for you,  your users groups,  BBS's, 
  47.           ect.   But  please,  make sure that you include  these  files 
  48.           everytime  you distribute it.  There is nothing that  I  hate 
  49.           worse,  than  not  getting  all the files needed  to  make  a 
  50.           program perform properly.
  51.           
  52.                MEGMATIC.PRG
  53.                CONFIG.PRG
  54.                MEGMATIC.DOC
  55.  
  56.              As I said earlier, MegaMatic is shareware.  If you like it 
  57.           and  use it,  send TIF Software a few bucks.   If  you  don't 
  58.           like, let us know why.
  59.  
  60.              Now, on to the good stuff.
  61.           
  62.           
  63.           
  64.                                     Page -1-
  65.           
  66.           
  67.  
  68.                Introduction
  69.                (or "where did I come up with this idea")
  70.  
  71.              When  I first bought my ST,  I didn't know anything  about 
  72.           the AUTO folder and how to use it.   But before too  long,  I 
  73.           had 5-6 programs in my AUTO folder that 'I just had to have'.  
  74.           Between these 5-6 programs and 3-4 accessories, it was taking 
  75.           forever to boot up my computer (even with a hard drive).   So 
  76.           to make life easier (and faster),  I decided to take the best 
  77.           ideas from each of these 'AUTO programs' and incorporate them 
  78.           into one program.
  79.  
  80.              The first problem that I ran into was that I HATE 'all-in-
  81.           one' programs.   Usually there was only 1 or 2 parts of these 
  82.           'all-in-one'  programs  that I used.   All the  rest  of  the 
  83.           program  (along with my computers memory) was wasted.   So  I 
  84.           decided  to make MegaMatic a 'all-in-one' program  where  the 
  85.           USER (that's you!) could decide what parts of it THEY  wanted 
  86.           to use.  In other words, much of MegaMatic is configurable by 
  87.           the user.   The parts that are not configurable (listed later 
  88.           in the docs) do not take up any memory after boot  up.   Once 
  89.           they do their job, they disappear from the computers memory.
  90.  
  91.              Also,  I HATE AUTO programs that 'asks questions' and then 
  92.           sits there until the user gives an input.   I want to be able 
  93.           to  turn  on my system and go do anything I want and  when  I 
  94.           come back,  it's all up and ready to go.  MegaMatic at bootup 
  95.           has  two  areas where it asks for user input (more  on  these 
  96.           later).  At each spot, MegaMatic will wait for approximately. 
  97.           1 second for an input.   If no input is  received,  MegaMatic 
  98.           will then continue on and just use the default input.
  99.  
  100.              Since I don't know C,  Pascal or Modula,  I was forced  to 
  101.           write  MegaMatic in pure 68000 assembly code (it  was  either 
  102.           that  or  GfA Basic).   MegaMatic was written  with  HiSoft's 
  103.           DevPac  Editor/Assembler.   Since  MegaMatic was  written  in 
  104.           68000  code,  you'll find it short (less than 4k)  and  fast.  
  105.           Also, once MegaMatic has been booted and is running,  it only 
  106.           takes 1k of your precious memory to run (that does not  count 
  107.           the memory needed for the ramdisk or print spooler however).
  108.  
  109.              To  make  the program user configurable,  I also  wrote  a 
  110.           CONFIG.PRG that goes along with MegaMatic.   You HAVE to  use 
  111.           the CONFIG.PRG on MegaMatic before using MegaMatic.  (more on 
  112.           CONFIG.PRG later)
  113.           
  114.  
  115.  
  116.                 How to install Mega-Matic
  117.                 (or "if you don't follow instructions, don't blame me")
  118.  
  119.              ALWAYS make a backup of all the files before attempting to 
  120.           use any of them.
  121.  
  122.              MEGMATIC.PRG  HAS to be configured with CONFIG.PRG  before 
  123.           using it.
  124.  
  125.              MEGMATIC.PRG HAS to go into the AUTO folder first.  (Sorry 
  126.           guys,  but  I  have  to know what some of  the  lower  memory 
  127.           address's  are  before some  other  program  modifies/changes 
  128.           them.)   If you are running a hard drive booter in your  AUTO 
  129.           folder, it can go in before the MEGMATIC.PRG.
  130.           
  131.                                     Page -2-
  132.           
  133.           
  134.              Mega-Matic's basic features
  135.              (or "I thought that this part would never get here")
  136.  
  137.  
  138.              1)  RESETTABLE RAM DISK **
  139.                  I've  heard the pro's and con's about  the  resettable 
  140.           ram disks.   To me, any ram disk that isn't resettable, isn't 
  141.           useable.   The resettable ram disk 'saved my bacon' more than 
  142.           once.   This ramdisk will survive a normal RESET with no loss 
  143.           of data.   But remember,  this is not guaranteed!!   99.9% of 
  144.           time  it works properly but .1% of the time the system  bombs 
  145.           beyond  repair and can corrupt the ram disk pointers  or  the 
  146.           data on the ramdisk.
  147.  
  148.                  Resettable  Ram Disks boot up a little different  than 
  149.           'normal' ram disks.   They take two 'passes' to boot up.  The 
  150.           first time MegaMatic is booted by the system,  it moves parts 
  151.           of itself into high memory (right under the graphics screen).  
  152.           It then modifies some of the lower memory pointers and does a 
  153.           warm reset which then causes it to be booted again.   It then 
  154.           looks to see if it's been booted before (by looking for  some 
  155.           'magic' data in high memory).   If it has been booted before, 
  156.           it then finishes it's job by hooking some of the lower memory 
  157.           vectors  into  the  program that has  been  moved  under  the 
  158.           graphics  screen.   At that point it returns to TOS and  lets 
  159.           the system finish booting up everything else.
  160.           
  161.                  This  ram disk is configurable in size from 128k to  2 
  162.           meg (minus 24k for 'overhead'...i.e. FAT tables, directories, 
  163.           ect.) with the CONFIG.PRG.
  164.           
  165.                  Also at powerup,  it can be te